<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN" "http://www.w3.org/TR/REC-html40/loose.dtd">
<HTML>
<HEAD>
<TITLE>Txt2tags User Guide</TITLE>
<META HTTP-EQUIV="Content-Type" CONTENT="text/html; CHARSET=iso-iso-8859-1">
<LINK REL="Start" HREF="index.html">
<LINK REL="Contents" HREF="index.html">
<LINK REL="Prev" HREF="PartIVMasteringTxt2tagsConcepts.html">
<LINK REL="Next" HREF="HeaderArea.html">
<STYLE TYPE="text/css"><!--
BODY { font-family: serif }
H1 { font-family: sans-serif }
H2 { font-family: sans-serif }
H3 { font-family: sans-serif }
H4 { font-family: sans-serif }
H5 { font-family: sans-serif }
H6 { font-family: sans-serif }
SUB { font-size: smaller }
SUP { font-size: smaller }
PRE { font-family: monospace }
--></STYLE>
<LINK REL="stylesheet" TYPE="text/css" HREF="userguide.css"></HEAD>
<BODY>
<A HREF="index.html">Contents</A>
<A HREF="PartIVMasteringTxt2tagsConcepts.html">Previous</A>
<A HREF="HeaderArea.html">Next</A>
<HR NOSHADE>

<H2><A NAME="5_1">The .t2t document Areas</A></H2>
<P> Txt2tags marked files are divided in 3 areas. Each area have its own
 rules and purpose. They are:</P>
<DL>
<DT><I>Header Area</I></DT>
<DD> Place for Document Title, Author, Version and Date information.</DD>
<DT><I>Config Area</I></DT>
<DD> Place for general Document Settings and Parser behavior modifiers.</DD>
<DT><I>Body Area</I></DT>
<DD> Place for the Document Content.</DD>
</DL>
<P> All areas are optional. You can write a txt2tags document with just
 headers (such as our first example), or a document with no headers or
 settings.</P>
<P> The areas are delimited by special rules, which will be seen in
 detail on the next chapter. For now, this is a representation of the
 areas on a document:</P>
<PRE>
             ____________
            |            |
            |   HEADERS  |       1. First, the Headers
            |            |
            |   CONFIG   |       2. Then the Settings
            |            |
            |    BODY    |       3. And finally the Document Body,
            |            |
            |    ...     |          which goes until the end
            |    ...     |
            |____________|

</PRE>
<P> In short, this is how the areas are defined:</P>
<TABLE ALIGN="center">
<TR><TD ALIGN="center"><B>Headers</B></TD><TD>First 3 lines of the file,
 or the first line blank for No Headers.</TD></TR>
<TR><TD ALIGN="center"><B>Config</B></TD><TD>Begins right after the
 Header (4th or 2nd line) and ends when the<I> Body Area</I> starts.</TD>
</TR>
<TR><TD ALIGN="center"><B>Body</B></TD><TD>The first valid text line
 (not comment or setting) after the<I> Header Area</I>.</TD></TR>
</TABLE>
<H3>Full Example</H3>
<PRE>
My nice doc Title
Mr. John Doe
Last Updated: %%mtime(%c)

%!target  : html
%!style   : fancy.css
%!encoding: UTF-8
%!options : --toc --enum-title

Hi! This is my test document.
Its content will end here.
</PRE>
 <A NAME="headers-area"></A><HR NOSHADE>
<A HREF="index.html">Contents</A>
<A HREF="PartIVMasteringTxt2tagsConcepts.html">Previous</A>
<A HREF="HeaderArea.html">Next</A>
</BODY>
</HTML>
